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ABSTRACT 


PEST is a non-time-shared program which gives a user access to an 
editor and an assembler on PHOENIX, a computer developed by The MITRE 
Corporation. PEST allows the user to enter, edit, assemble, load, debug, 
and execute a symbolic program. 
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SECTION I 


INTRODUCTION 

PEST (PAT EDITOR SYSTEM TENTATIVE) is a program which puts 
at the user* s disposal the tools necessary to assemble and run a program on 
the PHOENIX computer. PEST is an interim, non-time-sharing monitor 
which will be used until the time-sharing MONITOR is operational. Under 
PEST control, a programmer may use PAT (the macro-assembler), the 
EDITOR, and two debugging programs (DEBUGS and DEBUG1). 
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SECTION II 


DISCUSSION 


LOADING PEST FROM TAPE 

To load PEST into the machine, perform the following operations: 

(1) Mount a PEST system tape (preferably with the protect ring 
removed) on one of the tape drives. 

(2) Set tape-drive selector to logical ' £f' . At this point the tape 
should be at load-point (LOAD switch light ' on'), and the 
READY switch should be lighted. 

(3) At the console, with the 'CPU SINGLE-INSTRUCTION' switch 
down, press the 'MASTER RESET' button (Figure 1). 

(4) Press the ' LD FROM TAPE' button. A short bootstrap loader 
will be automatically loaded. 

(5) Push the ' COMPUTE' button. 

(6) Raise the 'CPU SINGLE-INSTRUCTION' switch. The tape will 
load itself onto the drum. When PEST is successfully loaded, 
the message ' pest on drum, please bring in drum bootstrap' 
will be typed out. 

(7) Tabs should now be set, if not already set. The recommended 
tab settings are at 15, 25, 5£f, 6£$, and 87 spaces to the right 
of the left-hand margin. 


2 



3 


Figure 1. Diagram of Relevant Portions of PHOENIX Console 

























LOADING PEST FROM DRUM 


To call in PEST from drum: 

(1) Depress the 'CPU SINGLE-INSTRUCTION' switch (i.e., put in 
'single-step' position). 

(2) Press the 'MASTER RESET' button. 

(3) Press the 'LD FROM DRUM' button. 

(4) Press the 'COMPUTE' button. 

(5) To transfer control to this program put 'CPU SINGLE¬ 
INSTRUCTION' switch up (i.e., into the 'automatic' position). 

Steps 1 through 4 cause a core loader to be transferred from the drum 
into core. Step 5 causes the remainder of the PEST program to be read into 
core from drum, and control to be transferred to the PEST program proper. 

The program will then pause, waiting for the SOM key to initialize the 
typewriter subroutines. The first action of PEST after receiving the SOM 
pulse is to type out the message: 

'control'. 

The program then waits for an appropriate control character to be 
typed in. 

Legitimate Control Characters 

Table I lists the legitimate control characters and describes their actions. 
Illegitimate Control Characters 

An attempt to type in a character not enumerated in the above table will 
cause the message 
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Table I 


Legitimate Control Characters 


Character 

Action 

c 

loads code for execution 

d 

brings in DB6 

D 

brings in DB1 

e 

brings in ' EDITOR' 

f 

loads 1 EDITOR' files from magnetic tape 

p 

brings in working copy ' PAT' 

p 

brings in fresh ' read-only' version of ' PAT' 

s 

saves DB1 

T 

terminates ' PEST' 


'illegal command' 

to be typed out. This is followed by a return to the start of the program. 
FILES FROM TAPE 

Data can be entered into the EDITOR files from a suitably prepared 
tape (Appendix I). PEST will normally load only four files from the tape. 

If there are more than four files on the tape, PEST will complain 

'too many files on tape, only 4 loaded', 

and control will be handed back to PEST. At this point the tape will be posi¬ 
tioned just beyond an end-of-file mark and be well-placed for reading further 
files from tape. 


5 













The PEST command which initiates the action of loading files from tape 
is the typing of an 'f*. The response is: 

'_files to be prepared from tape'. 

'please mount protected source tape on tape drive 0'. 

'please type a 'y' when ready'. 

If any character other than a 'y' is typed in, PEST will loop back and 
try the last two messages again. 

When a 'y* is typed in, PEST will load the tape onto drum and build a 
drum-list to hand down to the EDITOR. 

The successful completion of the operation will be signalled by the 
message: 

'files from tape successfully loaded'. 

Before these files can be used with the EDITOR, the EDITOR must be 
reinitialized by using its 'reinitialize' command'. ^ 

THE EDITOR UNDER PEST CONTROL 

When PEST is in the 'control' mode and an 'e' is typed in, the program 
responds by typing out the rest of the message: 

'^ditor requested'. 

PEST will then move the EDITOR program from the drum to core, and 
it will transfer control to the EDITOR. 

The first action the EDITOR expects is striking of the SOM key, which 
will cause initialization of the typewriter subroutines and typing of the message: 

'the editor is ready'. 
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From this point on, the EDITOR program is firmly in control. * 

EDITOR Output for PAT Processing 

After the editing phase is complete, it will generally be the practice to 
'hand down' an edited file to PAT for processing. This process is accom¬ 
plished by 'opening' the relevant file and then ordering the EDITOR to 
'terminate'. 

This procedure causes the 'opened' file to be copied, starting in a particu¬ 
lar field on the drum so that it can be accessed by PAT. Control then returns 
to PEST. 

PAT UNDER PEST CONTROL 

When PEST is in the 'control' mode and a 'p' is typed in, the program 
responds by typing out the rest of the message: 

'£at requested'. 

PEST will then move the PAT program from the drum to core and 
transfer control to the PAT program. 

The first action the PAT program expects is striking of the SOM key 
which will cause initialization of the typewriter subroutines and typing of the 
message: 

'pat ready'. 

This message is immediately followed by a request to the user to specify 
the mode of input of the source language. The request takes the form of the 
typeout: 

'type t, m, or e'. 
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If any other character is typed in, the message, 

'illegal input source, try again', 

will be typed out, and the sequence just described starts again with the 
message: 

'pat ready'. 

Typewriter Input to PAT 

If a *t* is typed, PAT will be initialized to expect input from the type¬ 
writer keyboard. The program will acknowledge the input of the 't’ by 
completing the message: 

'-typewriter input selected'. 

With typewriter input, PAT's PASS1 error messages will be printed out 
as the errors occur. The assembly can be terminated at any time by typing 
in right parentheses until PAT seizes control. 

Tape Input to PAT 

If an 'm' is typed, PAT will be initialized to expect input from a suitably 
prepared magnetic tape (see Appendix I). The program acknowledges the 
request by typing: 

'mag tape input needs protected source tape on tape drive 0' 

'please signal tape ready by typing a 'y' ' . 

If any character other than a 'y' is typed in, the message will be repeated. 
When a 'y' is typed in, the next message out will be: 

'depress sense-switch 1 for type-out' . 
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This message means that the input from the tape can be monitored as 
it comes in. Monitoring is initiated by depressing the sense-switch. Raising 
the switch at any point simply shuts off the type-out and has no effect on the 
way the program runs. 

A virgin copy of PAT is available in case it should be expedient to make 
a fresh start with an uncluttered symbol table. This ’clean' version is 
’read-only’ in the sense that it cannot be saved in the way that the working 
version can. 

To call in the fresh version of PAT, get PEST in the ’control' mode and 
type in a 'P' . Pest will indicate that the read-only version has been 
requested by typing: 

'PAT requested' . 

From this point on, the regular PAT procedures apply. 

EDITOR Input to PAT 

If an 'e' is typed, PAT will be initialized to expect input from the EDITOR 
(see EDITOR Output for PAT Processing). The program acknowledges 'he 
selection by typing 

'editor input' . 

The message: 

'depress sense-switch 1 for type-out' 
reminds the user that the input from the edited file can be monitored as it 
comes in by depressing sense-switch 1. Raising the switch at any subse¬ 
quent time simply shuts off the type-out and has no further effect on the 
running of the program. 
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Input-Independent PAT-PEST Conventions 


Because PAT requires a name for each program it assembles, it 
requests: 

'please type in a three-character identifying name' . 

Each program should have a unique name. Once this name has been 
entered, the PAT program proper takes over. 

If the input is from the typewriter, the 'input status' light (Figure 2) 
will be energized, indicating that PAT is waiting for input from the keyboard. 
If input is from magnetic tape or the EDITOR, the input will be automatically 
read in from the appropriate source. 

2 

From this point on, the PAT ground rules apply. 

The Aftermath 

After PAT has successfully processed the source program, it will give 
the user the following options (in the order described): 

Typing a Listing 

The message: 

'for a listing of the output code, typ e a 'y' please' , 
gives the programmer the choice of having the output code listed. Any 
character other than a 'y' will suppress the listing. 

Saving the Output Code 

The output code, if any, can be saved on drum for subsequent execution 
under the control of the PEST program. It will be accessible through the 
three-character name given to it at the start of the PAT run. 
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Figure 2. Relevant PHOENIX Typewriter Keys 




















































































The message: 

'type a 'y' to save this code for running' , 
will indicate that the time to make the choice has come. 

Any character other than a 'y' will cause the output code to be discarded. 

Typing the Symbol Table 

The message: 

'symbol-table printout: e = entire , p = partial' 
gives the user the choice of printing the PAT symbol table in whole or in 
part, or, by typing a character other than an 'e' or a 'p', of bypassing this 
operation altogether. The only difference between the 'entire' and the 'partial' 
symbol-table listing is that the 'null tail' and the symbols with this tailing* are 
elided. 

If the SOM key is pressed while the symbols under a particular tail are 
being typed out, the remainder of the symbols under this tail will not be typed 
out. Instead, the next tail in sequence will be announced, and the symbols 
associated with it will be listed. Thus, by judicious use of the SOM key, any 
selected portion of the symbol table can be listed. 

Preserving the Symbol Table 

PEST preserves the PAT symbol table by copying the entire PAT pro¬ 
gram back on drum (overlaying the previous version). The message: 

'to save this version of PAT, type a 'y", 
announces that the decision, whether or not to save the version of PAT 
currently in core, must be made. 

* 

The first set of symbols to be typed consists of those with no tail (the null 
tail). All remaining tails appear in alphabetical order, i.e., a, a:a, a:b, 

a:b:c, b, b:a. Symbols with the same tail are also listed in alphabetical 

order. 
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Any character other than a *y' will transfer control back to PEST, 
leaving the 'old' version of PAT unchanged. 

If the new version is saved, control is handed back to PEST after PAT 
has been saved. 

LOADING CODE FOR EXECUTION OR DEBUGGING 

This section presupposes that one or more programs have been com¬ 
piled by PAT and that the PAT option of saving the code has been exercised. 

PEST provides the facilities for calling for this code by 'name' and 
having it loaded into core in the appropriate locations. (If a non-unique name 
was chosen, only the most recent version is accessible.) 

To accomplish loading, the user types a 'c' and the response is: 

'code loader requested'. 

'type a 'y' for code list printout'. 

If a 'y' is typed in, the 'names' of the stored programs will be typed 
out, preceded by 'name of code' and followed by 'end of code list'. If any 
other character is typed in, no listing will be produced. 

The next request by the program will be: 

'please type in name of program to be loaded'. 

At this point a three-character name (which should be one of the names 
in the list) is expected from the user. When this has been typed in, the 
designated program will be retrieved from the drum and loaded into core. 

Should the user request a program which is not named in the list of 
stored programs, the message: 
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'program identity unknown, try again please', 
will appear, and the program will then cycle back to type: 

'type a 'y' for code list printout'. 

PEST will indicate that the specified program has been found and 
loaded by typing out: 

'program loaded and ready to transfer to location*****' 

'an 'x' transfers control, a 'D' brings in dbl, a'd* brings in db0'. 

If the symbolic input to PAT ended with an 'end' statement, ***** is the 
address named in the 'end' statement. If no 'end' statement was included, 

***** w jJQ I 01. 

In this case (as in the case where the starting location was intended to 
be 0), control will not be transferred and PEST will keep typing the same 
message asking for an 'x', a 'D' or a 'd', even if an 'x' is typed in. In 
short, control cannot be transferred to location 0 directly. If the user 
really wants to start a program at '0' , it must be done under control of one 
of its debugging programs. It should be remembered that locations 0 through 

3 

7 are used by the trap instructions and interrupts. 

If any character other than an 'x', 'd', or 'D' is typed in, PEST expects 
that more code is to be loaded, so it cycles back and types: 

'please type in name of program to be loaded', 
again, and the sequence repeats itself. 

A program to be executed under control of either of the debugging 
programs must not overlap that program in core, of course (Appendix II). 
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DEBUG0 


DEBUG0 (or DB0) is a debugging program which provides minimal 

4 

capabilities for debugging a program on the PHOENIX computer. It requires 
a relatively small amount of core storage. 

To call DB0, the command 'd' is typed in. The system responds: 

'debug0 requested'. 

The typewriter subroutines must be initialized by the SOM key. 

The user may wish to return to the PEST program at some point. If 
there is reasonable assurance that the core region from 20 to 176 is 

O O 

untouched, control can be transferred by typing in 

'20g' . 

If the status of the core region in question is in doubt, the PEST pro¬ 
gram will have to be brought in from drum in the usual way. 

Space Requirements for DB0 

The area of core occupied by DB0 is given in Appendix II. 

DEBUG1 

DEBUG1 (or DB1) is a symbolic debugging program providing operation 
definition capabilities to assist and expedite the difficult and time-consuming 
process of checking out programs. 

To Call DEBUG1 

To call DB1, the command 'D' is typed in. The system responds: 

'Debugl requested'. 

The typewriter subroutines must be initialized by means of the SOM key. 
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Use of DEBUG1 


The use of DB1 is fully described in Reference 4. 

The user may wish to return to the PEST program at some point. If 
there is reasonable assurance that the core region from 20 to 176 is un- 

O O 

touched, control can be transferred by typing in 
'start 20' . 

If the status of the core region in question is in doubt, the PEST program 
will have to be brought in from drum in the usual way. 

Space Requirements for DEBUG1 

The area of core occupied by DEBUG1 is shown in Appendix II. 

TERMINATE 

When the user wishes to capture the system in a particular state (as a 
backup or when getting off the machine), PEST will make a tape which, when 
loaded in, will recreate the system as it was when captured. The command 
for this action is a 'T' which initiates the following sequence of messages: 

'germination requested' . 

'please mount unprotected blank tape on tape drive 1' . 

'please type a 'y' to indicate output tape ready'. 

When these requests are complied with, PEST will create a new tape and 
signal completion of the action by the message: 

'output tape complete'. 
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The newly-created tape is a PEST system tape containing all system 
programs, current user files, and changes made to PAT and EDITOR 
symbol tables. 

Upon request, a fresh PEST system tape may be obtained. This tape 
contains all system programs but no user files or definitions. The PAT 
symbol table contains the PHOENIX machine opcodes and those symbols 
essential to the operation of PAT. The EDITOR files contain a set of 
PHOENIX supplementary opcodes given in Appendix III. The user may, at 
his discretion, either add them to PAT or discard them. The entire cycle 
can now be repeated using this tape. 

After terminating, control will be handed back to the PEST program. 
Should the user wish to continue working with the PEST system currently 
on drum, he should proceed as usual. 

It should be noted that whenever a PEST system is loaded from tape, 
an EDITOR file should be opened if PAT is to be rim. The user must not 
assume that the file previously opened for handing down to PAT is still in 
existence. 
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APPENDIX I 


MAGNETIC TAPE DATA INPUT 


PROCEDURE A 

The system will accept card images on magnetic tape at two different 
points. PEST will accept a tape containing up to four files which are for¬ 
warded to the EDITOR. (The four files will be arbitrarily labeled by the 
EDITOR as FILEA, FILEB, FILEC, and FILED.) Such a tape can be ob¬ 
tained by following Procedure B below. 

PAT will accept a tape containing one file which must be in a different 
format from those for the EDITOR. The tape is prepared by following 
procedures B and C below. 

The PHOENIX ICS character codes and combinations of card-code 
characters used to represent them are shown in Appendix IV. 

PROCEDURE B 

Submit a reel of tape and a deck of cards to the 7030 facility and request 
a PRESTO run. 

If an unlabeled tape is used, the first card in the deck must be a card 
with CTL NOLABEL on it, with the 'C' in column 6 and the 'N' in column 10. 

A tape file is defined to be a sequence of card images delimited by an 
’end-of-file' mark. 

An 'end-of-file' mark can be requested by inserting, at the appropriate 
place in the deck, two control cards, viz.: 

(1) a card with 4, 5, 6, 7, 8, and 9 punched in column 1, followed 
immediately by 
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(2) a card with CTL FILE where the 'C' is in column 6 and the 'F' 
is in column 10. 

No control cards are needed at the end of the deck. After the last card, 

5 

two 'end-of-file' marks are automatically written on the tape. 

The tape, when it comes back, will have one 20-word record for each 
card image, each word containing four 6-bit BCD characters. 

PROCEDURE C 

The output tape from a PRESTO rim (procedure B) must be processed 
by the PHOENIX program TXFM into a form acceptable to PAT. The output 
from TXFM is a tape containing card images in the form of 27-word records, 
each w r ord containing three ICS characters. A copy of the program TXFM is 
available at the PHOENIX maintenance console. 
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APPENDIX H 


CORE MAP FOR PEST SYSTEM 


Location (octal) 

0 - 176 

PEST drum bootstrap 

200 

- 4000 

PEST control 

4000 

— 10000 

PEST buffers 

63000 

- 75227 

DB1 

75230 

- 76137 

PEST code-loading functions 

76140 

- 77777 

DB0 
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APPENDIX III 



PHOENIX SUPPLEMENTARY OPCODES 

NUL**, * 

'ZERO BASE W/ADDR + TAG 

ABS 

'ABSOLUTE VALUE OF AC 

ADI** 

'ADD A IMMEDIATE ** 

ARG**, * 

'ARGUMENT (24-BITS) TO AC 

ARGAC 

'ARGUMENT IS AC 

ARGI** 

'ARGUMENT I (16-BITS) 

ARGR** 

'ARGUMENT R (16-BITS) 

ARGX * 

'INDEX * TO AC 

ARGZERO 

'ARGUMENT ZERO 

CLA 

'LOAD ZERO INTO AC 

CPL 

'COMPLEMENT AC 

DAP ** 

'DEPOSIT ADDRESS PART OF AC INTO ** 

DZA ** 

'DEPOSIT ZERO ADDRESS AT ** 

FETCH R 

'FETCH LIVE REGISTER R TO AC 

GET R 

'GET RTH REGISTER TO AC 

GO ** 

'TRANSFER CONTROL UNCONDITIONALLY TO ** 

JMP ** 

'TRANSFER CONTROL UNCONDITIONALLY TO ** 

LAI ** 

'LOAD ** IMMEDIATE 

LAR ** 

'LOAD ADDRESS REMOTE FROM ** 

LAZ 

'LOAD ZERO INTO AC 

LDZ 

'LOAD ZERO INTO AC 

MBZ * 

'ZERO BIT * IN AC 

NIL ** 

'ONE FULL-WORD ARGUMENT 

NOP 

'NO OPERATION 

PUT R 

'PUT AC IN RTH REGSTR 
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PHOENIX SUPPLEMENTARY OPCODES (Cont'd.) 


RESET ** 

'RESET (SET TO ZERO) THE SWITCH ** 

SAB * 

'SKIP IF AC BIT * IS 1 

SETACBIT ** 

'SET AC BIT * TO 1 

SKP ** 

'SKIP ** LOCATIONS 

SLEZ 

'SKIP IF AC . LE. PLUS ZERO 

SKPOC 

'NR (MASKED) TO AC. SKIP IF PUP OP COMP 

SKPI 

'SKIP IF PUP IDLE 

SKPSSW* 

'SKIP ON SENSE-SWITCH * (0, 1, 2, 3) 

SGZ 

'SKIP IF AC . GR. PLUS ZERO 

SMA 

'SKIP MINUS AC 

SNA 

'SKIP NEGATIVE AC 

SNLZ 

•SKIP IF AC NOT LESS ZERO (ARITHMETIC) 

SNOV 

'SKIP IF NO OVERFLOW 

SNPZA 

'SKIP IF NOT PLUS ZERO AC 

SNZ 

'SKIP IF NON-ZERO (ARITHMETIC) AC 

SNZA 

'SKIP IF NON-ZERO AC (ARITHMETIC) 

SPA 

'SKIP IF POSITIVE AC 

SPZA 

'SKIP IF PLUS ZERO AC 

STASH R 

'STASH AC IN LIVE REGISTER R 

SZA 

'SKIP IF AC IS ZERO (ARITHMETIC) 

SZB 

'SKIP IF ZERO (ARITHMETIC) BR 

TBL **,* 

'ADDRESS FIELD + BITS 0-7 FIELD 

WRD ** 

'ONE FULL-WORD ARGUMENT 

XAB 

'EXCHANGE AC AND BR 


The 'R' refers to the registers in Table 9.46. 3 of Reference 1. 
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APPENDIX IV 


REPRESENTATION OF ICS-1 CHARACTERS 


Octal 

H. R. 

ICS 

Octal 

H. R. 

ICS 

Octal 

H. R. 

ICS 

Octal 

H. R. ICS 

000 

0 

0 

040 

W 

w 

100 

♦ 

* 

140 


001 

1 

1 

041 

X 

X 

101 

/ 

/ 

141 


002 

2 

2 

042 

Y 

y 

102 

$/ 

\ 

142 


003 

3 

3 

043 

Z 

z 

103 

$0A 

t 

143 


004 

4 

4 

044 

$A 

A 

104 

$0V 

1 

144 


005 

5 

5 

045 

$B 

B 

105 

$0K 


145 


006 

6 

6 

046 

$C 

C 

106 

$0R 

— 

146 


007 

7 

7 

047 

$D 

D 

107 

= 


147 


010 

8 

8 

050 

$E 

E 

110 

$0L 


150 


Oil 

9 

9 

051 

$F 

F 

111 

$0G 

> 

151 


012 

A 

a 

052 

$G 

G 

112 

( 

( 

152 


013 

B 

b 

053 

$H 

H 

113 

) 

) 

153 


014 

C 

c 

054 

$1 

I 

114 

$( 

[ 

154 


015 

D 

d 

055 

$J 

J 

115 

$) 

] 

155 


016 

E 

e 

056 

$K 

K 

116 

$6 

\ 

156 


017 

F 

f 

057 

$L 

L 

117 

$9 

/ 

157 


020 

G 

g 

060 

$M 

M 

120 



160 


021 

H 

h 

061 

$N 

N 

121 

, 

, 

161 


022 

I 

i 

062 

$o 

O 

122 

$. 


162 


023 

J 

j 

063 

$P 

P 

123 

$, 

; 

163 


024 

K 

k 

064 

$Q 

Q 

124 

m 

? 

164 


025 

L 

1 

065 

$R 

R 

125 

$$ 

$ 

165 


026 

M 

m 

066 

$S 

S 

126 

$0/ 

1 

166 


027 

N 

n 

067 

$T 

T 

127 

$= 

_ 

167 

$0S space 

030 

O 

o 

070 

$U 

U 

130 



170 

$- tab 

031 

P 

P 

071 

$V 

V 

131 



171 

$0B backspace 

032 

Q 

q 

072 

$vv 

w 

132 



172 

$0X index 

033 

R 

r 

073 

$x 

X 

133 



173 

$+ carriage return 

034 

S 

s 

074 

$Y 

Y 

134 



174 

$0P partial message 

035 

T 

t 

075 

$Z 

Z 

135 



175 

$0E end message 

036 

U 

u 

076 

+ 

+ 

136 



176 

$* null 

037 

V 

V 

| 077 

- 

- 

137 



177 

$0D delete 


H. R. = Hollerith Representation 

For example, the sequence 2 [ 5 t A:Q] . must be represented on an IBM card by 2$(5$0A$A$. $Q$)$, 
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APPENDIX V 



DRUM MAP 

Field (octal) 


0 

PEST 

1- 20 (inclusive) 

EDITOR files 

21- 30 

EDITOR 

31- 40 

PAT 

51- 52 

PAT files 

53- 54 

Code-loader, DB0, DB1 

55- 75 

EDITOR-PAT interface 

76-103 

Code storage 
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